Improve doc of gtk_widget_override_color()

Mention that it's not recursively applied to a container's children.

https://bugzilla.gnome.org/show_bug.cgi?id=566945

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 38c3e353b08b9222d6a46bb0888c4be493161685..fb6982da02fdb1c29570e7a5e238cd8fd38b9e04 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -9064,6 +9064,11 @@ _gtk_widget_get_modifier_properties (GtkWidget *widget)
  *
  * All other style values are left untouched.
  *
+ * This function does not act recursively. Setting the color of a
+ * container does not affect its children. Note that some widgets that
+ * you may not think of as containers, for instance #GtkButton<!-- -->s,
+ * are actually containers.
+ *
  * <note><para>
  * This API is mostly meant as a quick way for applications to
  * change a widget appearance. If you are developing a widgets